Skip to content

Add What's new in .NET 11 Preview 1 documentation #51583

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Open
Copilot wants to merge 13 commits into
base: main
Choose a base branch
from
Open

Add What's new in .NET 11 Preview 1 documentation #51583

Copilot wants to merge 13 commits into from
+277 −2

Conversation

Copy link
Contributor

Copilot AI commented Feb 10, 2026 •
edited by github-actions bot
Loading

Plan: Create What's new in .NET 11 articles for Preview 1

  • Create directory structure for .NET 11 what's new articles
  • Create overview.md for .NET 11
  • Create runtime.md for .NET 11
  • Create libraries.md for .NET 11
  • Create sdk.md for .NET 11
  • Update fundamentals TOC to include .NET 11 what's new articles
  • Update fundamentals TOC to include existing .NET 11 breaking changes
  • Verify all articles follow documentation standards
  • Test build and validate links
  • Address review feedback:
    • Updated intro paragraph in all 4 articles to "It was last updated for Preview 1"
    • Removed blank titleSuffix from all articles (first round)
    • Removed blank lines from breaking changes list in libraries.md
    • Added C# 15 section to overview.md
    • Updated docs/whats-new/index.yml to include .NET 11 section
  • Address additional review feedback:
    • Added titleSuffix: "" and ms.update-cycle: 3650-days to all 4 articles
    • Updated ms.date in index.yml from 07/01/2025 to 02/10/2026
    • Fixed ASP.NET Core link in index.yml to use /aspnet/core/release-notes/aspnetcore-11.0 (consistent with .NET 10 pattern)
  • Address final review feedback:
    • Removed "Additional breaking changes" section from libraries.md (breaking changes should not be in what's new articles)
    • Updated all API references to link to specific overloads with full signatures instead of generic xref links
    • Updated redirection in .openpublishing.redirection.core.json to point to .NET 11 overview
Original prompt

This section details on the original issue you should resolve

<issue_title>[New article]: What's new in .NET 11</issue_title>
<issue_description>Use the prompt in https://github.com/dotnet/docs/blob/main/.github/prompts/whats-new-net.md to create the "What's new" articles for .NET 11, as of Preview 1.

You'll need to create new articles, and add new nodes to the fundamentals TOC for .NET 11. When you edit the TOC, include the existing article for breaking changes in .NET 11 (as of preview 1).</issue_description>

<agent_instructions>You can see the example TOC changes in this closed PR: #51577</agent_instructions>

Comments on the Issue (you are @copilot in this section)

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

Internal previews

📄 File 🔗 Preview link
docs/core/whats-new/dotnet-11/libraries.md docs/core/whats-new/dotnet-11/libraries
docs/core/whats-new/dotnet-11/overview.md docs/core/whats-new/dotnet-11/overview
docs/core/whats-new/dotnet-11/runtime.md docs/core/whats-new/dotnet-11/runtime
docs/core/whats-new/dotnet-11/sdk.md docs/core/whats-new/dotnet-11/sdk
docs/fundamentals/toc.yml docs/fundamentals/toc
docs/whats-new/index.yml docs/whats-new/index

@BillWagner
Add What's new in .NET 11 articles for Preview 1
a371d54 
Co-authored-by: BillWagner <493969+BillWagner@users.noreply.github.com>
Copilot AI changed the title [WIP] Add new article for What's new in .NET 11 Add What's new in .NET 11 Preview 1 documentation Feb 10, 2026
Copilot AI requested a review from BillWagner February 10, 2026 16:52
BillWagner
BillWagner reviewed Feb 10, 2026
View reviewed changes
Copy link
Member

@BillWagner BillWagner left a comment •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@copilot I have comments for you to address

In addition to the comments on specifics in this PR, update https://github.com/dotnet/docs/blob/main/docs/whats-new/index.yml to include a block for .NET 11 with links to this article

@BillWagner
Copy link
Member

BillWagner commented Feb 10, 2026

@copilot Please address all review comments

@BillWagner
Address review feedback: update article intro, remove titleSuffix, ad…
a69e163 
…d C# 15 section, update index.yml

Co-authored-by: BillWagner <493969+BillWagner@users.noreply.github.com>
Copy link
Contributor Author

Copilot AI commented Feb 10, 2026

@copilot I have comments for you to address

In addition to the comments on specifics in this PR, update https://github.com/dotnet/docs/blob/main/docs/whats-new/index.yml to include a block for .NET...

All review comments addressed and docs/whats-new/index.yml updated with .NET 11 section. Commit a69e163

Copilot AI requested a review from BillWagner February 10, 2026 17:18
BillWagner
BillWagner approved these changes Feb 10, 2026
View reviewed changes
Copy link
Member

@BillWagner BillWagner left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

One more update, and then this is ready.

BillWagner
BillWagner reviewed Feb 10, 2026
View reviewed changes
@BillWagner BillWagner marked this pull request as ready for review February 10, 2026 20:04
@BillWagner BillWagner requested a review from a team as a code owner February 10, 2026 20:04
Copilot AI review requested due to automatic review settings February 10, 2026 20:04
Copilot AI reviewed Feb 10, 2026
View reviewed changes
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds the initial “What’s new in .NET 11 (Preview 1)” documentation set and wires it into the docs navigation so readers can find the new content from the fundamentals TOC and the global “What’s new” landing page.

Changes:

  • Added new .NET 11 “What’s new” articles: overview, runtime, libraries, and SDK.
  • Updated docs/fundamentals/toc.yml to include the new .NET 11 articles alongside existing .NET 11 breaking changes.
  • Updated docs/whats-new/index.yml to add a .NET 11 section on the landing page.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 10 comments.

Show a summary per file
File Description
docs/whats-new/index.yml Adds a .NET 11 entry to the “What’s new” landing page.
docs/fundamentals/toc.yml Adds TOC nodes for the .NET 11 “What’s new” articles and links breaking changes.
docs/core/whats-new/dotnet-11/sdk.md New .NET 11 SDK/tooling “what’s new” article with a breaking change highlight.
docs/core/whats-new/dotnet-11/runtime.md New .NET 11 runtime “what’s new” article focusing on hardware baseline changes.
docs/core/whats-new/dotnet-11/overview.md New .NET 11 overview page linking to the runtime, libraries, SDK, and other areas.
docs/core/whats-new/dotnet-11/libraries.md New .NET 11 libraries “what’s new” article summarizing API and behavior changes.

BillWagner and others added 4 commits February 10, 2026 15:17
@BillWagner
Update docs/core/whats-new/dotnet-11/libraries.md
f5b5af3 
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
@BillWagner
Update docs/core/whats-new/dotnet-11/sdk.md
32f7a05 
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
@BillWagner
Update docs/whats-new/index.yml
6736cd2 
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
@BillWagner
Update docs/core/whats-new/dotnet-11/overview.md
43f06a1 
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
@BillWagner
Add titleSuffix and ms.update-cycle to all articles, update ms.date i…
5ce604c 
…n index.yml, fix ASP.NET Core link consistency

Co-authored-by: BillWagner <493969+BillWagner@users.noreply.github.com>
Copilot AI requested a review from BillWagner February 10, 2026 20:21
@BillWagner
Copy link
Member

BillWagner commented Feb 10, 2026

closing and reopening for a fresh build

@BillWagner BillWagner closed this Feb 10, 2026
@BillWagner BillWagner reopened this Feb 10, 2026
@BillWagner BillWagner enabled auto-merge (squash) February 10, 2026 22:46
@BillWagner
Copy link
Member

BillWagner commented Feb 10, 2026

The warnings remaining are because the .NET 11 preview 1 APIs aren't published yet.

@BillWagner BillWagner disabled auto-merge February 10, 2026 22:51
gewarren
gewarren reviewed Feb 10, 2026
View reviewed changes
gewarren
gewarren reviewed Feb 10, 2026
View reviewed changes
@BillWagner
Remove breaking changes section from libraries.md as requested
2aed417 
Co-authored-by: BillWagner <493969+BillWagner@users.noreply.github.com>
@BillWagner
Link to specific new overloads throughout libraries.md
0298866 
Co-authored-by: BillWagner <493969+BillWagner@users.noreply.github.com>
@BillWagner
Copy link
Member

BillWagner commented Feb 11, 2026

@copilot One more change to make:

In openpublishing.redirection.core.json change the redirect_url on line 1861 from dotnet-10/overview to dotnet-11/overview

@BillWagner
Update redirect URL to point to .NET 11 overview instead of .NET 10
25f5a30 
Co-authored-by: BillWagner <493969+BillWagner@users.noreply.github.com>
Copy link
Contributor Author

Copilot AI commented Feb 11, 2026

@copilot One more change to make:

In openpublishing.redirection.core.json change the redirect_url on line 1861 from dotnet-10/overview to dotnet-11/overview

Updated line 1861 in .openpublishing.redirection.core.json to redirect to dotnet-11/overview instead of dotnet-10/overview. Commit 25f5a30

@BillWagner
Copy link
Member

BillWagner commented Feb 11, 2026

@gewarren

Copilot made all the requested updates. Do you want to give it another look?

(After this is merged, I'll update the prompt with notes based on the reviews)

@BillWagner
Copy link
Member

BillWagner commented Feb 11, 2026

Warnings are xref only.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@gewarren gewarren gewarren left review comments

Copilot code review Copilot Copilot left review comments

@adegeo adegeo adegeo approved these changes

@BillWagner BillWagner Awaiting requested review from BillWagner BillWagner is a code owner

Assignees

@BillWagner BillWagner

Copilot code review Copilot

Labels

dotnet-fundamentals/svc

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

[New article]: What's new in .NET 11

4 participants

@BillWagner @gewarren @adegeo